home *** CD-ROM | disk | FTP | other *** search
/ SPACE 1 / SPACE - Library 1 - Volume 1.iso / misc~1 / 30 / kermit.doc < prev    next >
Encoding:
Text File  |  1986-12-04  |  10.2 KB  |  246 lines
  1.                           GEM-Kermit for the ATARI ST
  2.                           ---------------------------
  3.  
  4.  
  5. I'm posting the GEM-Kermit, an implementation of the kermit file-transfer
  6. protocol, which makes use of the GEM-capabilities to present a 
  7. friendlier user-interface than "the other" kermit. Besides of that,
  8. GEM-Kermit can interact with IBM mainframes, a skill which the dev.-kit 
  9. kermit lacks.
  10.  
  11. GEM-Kermit was implemented by Bernhard Nebel of Technical University
  12. Berlin, W-Germany. For comments, gripes, suggestions or complaints
  13. please contact HIM (nebel@db0tui11.bitnet). I'm only a poor irresponsible
  14. person, who posts GEM-Kermit to netland because Bernhard has no 
  15. direct access to usenet.
  16.  
  17. Cheers, axel@coma.uucp
  18.  (Axel Mahler, Tech.Univ.-Berlin)
  19.  
  20.  
  21. P.S.: The main difference to the kermit program supplied with the
  22.       Atari development kit, is the support of IBM-communication and
  23.       a *much* nicer user-interface.
  24.  
  25.  
  26.  
  27. Known problems with GEM-Kermit:
  28.  
  29.    - during transfer, it happens sometimes, that the ST thinks some
  30.      button is depressed and starts an awful klicking (provided,
  31.      keyklick is enabled). After depressing any key the noise
  32.      disappears.
  33.    - in the RS232 configuration, character size has to be 8. If
  34.      cs is 7, all opening braces ('{') get lost (nobody knows why - yet).
  35.  
  36. When communicating with IBM mainframes, make sure the following 
  37. conditions are met:
  38.  
  39.    - binary transfer requires both kermits to be in binary mode.
  40.    - select character size 8 bits/char (see above).
  41.    - turn XON/XOFF-processing off. This is necessary, because XON is
  42.      the handshake-character for half-duplex comm.-lines.
  43.    - run your accoustic-coupler in full-duplex mode if it tends
  44.      to echo in half-duplex mode.
  45.  
  46.  
  47. Send your bug reports, cheers, complaints, suggestions, hate-mail to:
  48.   nebel@db0tui11.bitnet                                [the author]
  49. General (read:non-technical) problems with the download, basic use,
  50. etc. of the program may be addressed to:
  51.   Christopher F. Chabris (73277,305)          [the CIS distributor]
  52.   chabris%h-sc4@harvard.ARPA
  53.   h-sc4!chabris
  54. Please do your best _not_ to bother any one else mentioned in this
  55. document!  Thanks.
  56.  
  57. Full documentation follows -- ENJOY!
  58.  
  59.  
  60.  
  61. 1. GEM ATARI/ST Kermit
  62.  
  63. Author:           Bernhard Nebel, Technische Universitaet Berlin
  64. Contributions by: Bill Catchings, Bob Cattani, Chris Maic (Columbia Univ.),
  65.                   who wrote the 'minimal' C-Kermit and
  66.                   Glean Seaton, Robert A. Larson,
  67.                   who modified from UNIX Kermit to OS9 Kermit
  68. Language:         DRI C
  69. Documentation:    Bernhard Nebel
  70. Version:          1.01
  71. Date:             June 1986
  72.  
  73. GEM Kermit capabilities at a glance:
  74.  
  75.   Local operation:                 Yes
  76.   Remote operation:                No
  77.   Transfer text files:             Yes
  78.   Transfer binary files:           Yes
  79.   Wildcard send:                   Yes
  80.   ^X/^Y interruption:              Only simple abort
  81.   Filename collision avoidance:    Yes
  82.   Can time out:                    Yes
  83.   8th-bit prefixing:               Yes
  84.   Repeat count prefixing:          No
  85.   Alternate block checks:          No
  86.   Terminal emulation:              Provided by accessory
  87.   Communication settings:          Yes (RS232 par. by accessory)
  88.   Transmit BREAK:                  If accessory can
  89.   Handshaking (for IBM):           Yes
  90.   Transaction logging:             Yes
  91.   Session logging:                 Yes
  92.   Raw transmit:                    Yes
  93.   Act as server:                   No
  94.   Talk to server:                  Yes
  95.   Advanced server functions:       No
  96.   Advanced commands for server:    No
  97.   Local file management:           Yes
  98.   Handle attribute packets:        No
  99.   Command/init files:              Yes (only for non-RS232 par.)
  100.   Command macros:                  No
  101.  
  102. GEM Kermit is a program that implements the KERMIT file transfer protocol
  103. for ATARI/ST micros running GEM. It is written in DRI C. The implementation
  104. is based on OS9 Kermit, Version 1.5, a modified 'minimal' implementation
  105. of Kermit in C. The main advantage of GEM Kermit compared with DRI's
  106. Kermit is that it is able to talk with IBMs and that it uses the GEM user
  107. interface.
  108.  
  109. 2. Program operation
  110.  
  111. GEM Kermit can be evoked as any other GEM application just by clicking
  112. on the icon twice. A resource file 'KERMIT.RSC' has to present in the
  113. same directory as Kermit resides for proper opertation. Otherwise the
  114. program will abort with an error message. If a file 'KERMIT.INI' exists
  115. it is used to setup the communication parameters (except for RS232
  116. parameters).
  117.  
  118. After the program is started the familiar desktop and a menu bar should
  119. appear on the screen. Now you can start to transfer everything
  120. back and forth between your ATARI/ST and the other machine. If it does
  121. not work, you probably forgot to connect both with the appropriate
  122. wires (use the RS232/modem plug!), or some communication parameters are
  123. wrong, or you are really stupid (or there is a bug in the program).
  124. In any case it might be helpful to study the next few chapters.
  125.  
  126. 3. Commands
  127.  
  128. Kermit commands are evoked by selecting a drop down menu item. These
  129. items will be discussed briefly in the following.
  130.  
  131. 3.1 DESK menu
  132.  
  133. That is the familiar DESK menu. The first item (KERMIT-Info) tells you
  134. something about the program itself and how I can be reached by e-mail.
  135. The other items should give you the capabilty to configure the RS232
  136. interface and to open a virtual terminal connection to the other
  137. computer. If this is not the case, ask your ATARI dealer what's wrong.
  138.  
  139. But be aware of a really strange bug in GEMDOS! If your are talking
  140. with a computer which uses only seven bits with the 8th bit always mark,
  141. you loose the '{' if 7 bits with 8th bit = mark is selected. Isn't that
  142. strange? But with 8 bits selected everything works fine.
  143.  
  144. 3.2 FILE menu
  145.  
  146. This menu gives you the ability to DELETE, RENAME and TYPE files.
  147. Files are selected by the standard file selection dialog box.
  148. Be aware that wilcards in a delete command do not have the expected
  149. effect, but they will select the first file matching the specification.
  150. Additionally, you can get information about free space on a disk.
  151. And of course, the QUIT command is also present in this menu.
  152.  
  153. 3.3 TRANSFER menu
  154.  
  155. All transfer commands (SEND, RECEIVE, GET, PUT, LOGOUT server, QUIT server)
  156. can be found in this menu. Files and directories for these commands are
  157. again selected by the standard file selection dialog box. SEND and PUT
  158. handle wildcards in the right way. RECEIVE and GET will use a file
  159. specification as a name for the first file to receive, all other files
  160. will be stored under names sent by the remote host. If you do not
  161. input a file name also the first file transferred will be stored under
  162. the name provided by the remote host. In any case the files are stored
  163. in the selected directory.
  164.  
  165. 3.4 OPTION menu
  166.  
  167. In this menu commands for changing switches (e.g. BINARY TRANSFER, IBM
  168. MODE), starting and stopping logs (DEBUG and SESSION LOG), saving and
  169. restoring parameters (SAVE and RESTORE STATE) as well as evoking a parameter
  170. changing dialog are found. The details of these commands are not
  171. provided here, the interested user will find information about these
  172. in other Kermit publications or will learn how to use them by trial and 
  173. error, hopefully. The only thing I will mention is that the RS232 
  174. communication parameters (e.g. baud rate, byte format) are not included.
  175.  
  176. 4. How to install GEM Kermit*
  177.  
  178. If you got the program and the resource file (for German or English)
  179. as a binary excutable file, perhaps as a uudecoded file, everything
  180. should work out fine. Otherwise all the files with the STK prefix
  181. have to be compiled and linked (using STKERM.INP). The resource
  182. file must be renamed to KERMIT.RSC and you are ready.
  183. Currently, the following files are necessary:
  184.  
  185.  STKERM.C      main program
  186.  STKFIO.C      file I/O on the ATARI
  187.  STKGEM.C      GEM interface
  188.  STKGMO.C      GEM interface for changing options
  189.  STKGMT.C      GEM interface for transfer
  190.  STKGCM.C      QUIT/LOGOUT server
  191.  STKGET.C      GET from server
  192.  STKSEN.C      SEND protocol
  193.  STKREC.C      RECEIVE protocol
  194.  STKUTL.C      utility functions for Kermit protocol
  195.  STKINC.H      common include file for all Kermit modules
  196.  STKOBJ.H      object definitions for GEM Kermit
  197.  STKOBJ.DEF    for RCS (if you want to change the resource)
  198.  STKOBJ.RSC    (uudecoded) the German resource file or
  199.  STKOBE.RSC    (uudecoded) the English resource file
  200.                one of them has to be renamed to KERMIT.RSC 
  201.  
  202. The following files of the DRI C kit have to be modified:
  203.  GEMSTART.S    enlarge stack to 2k bytes and assemble
  204.  DEFINE.H      introduce the definition of NULL as 0L and change NIL to 0L
  205.  
  206. 5. Problems
  207.  
  208. - As said above, there seems to be a bug in GEMDOS eating all '{' when
  209.   the 7 bit mode is selected.
  210.  
  211. - If you move the mouse during a transfer, it can happen that key
  212.   clicks appear. I don't know why.
  213.  
  214. 6. Wish list
  215.  
  216. I spent a lot of time to adopt OS9 Kermit to GEM. As a matter of fact,
  217. I wrote more code than I used from the original program. Finally, I
  218. discovered that it would have been worth the effort to use the more
  219. recent C-Kermit. However, it's done now. If there is anybody out there,
  220. s/he is invited to adopt C-Kermit to GEM using my first hack.
  221. Besides that, there are a lot of other wishful improvements I probably
  222. will not work on:
  223.  
  224. - GEM Kermit seems to be rather slow on fast connections, i.e. 100-150
  225.   bytes/secs on a 9600 baud connection. 
  226.  
  227. - It would be nice to get the logs on a scroll window.
  228.  
  229. - The RS232 parameters should also be saved and restored by the STATE SAVE
  230.   and RESTORE commands. However, I was  not able to figure out how this 
  231.   could be done.
  232.  
  233.  
  234.  
  235. * Please note that all information pertaining to the source code for
  236.   the program does _not_ apply to the CompuServe distribution by
  237.   Christopher F. Chabris (73277,305).  ONLY the following files were
  238.   posted to DL2 of the ATARI16 Forum:
  239.      KERMIT.PRG
  240.      KERMIT.RSC
  241.      IBMTTY.ACC
  242.      KERMIT.DOC (the file you're reading)
  243.   Thanks!
  244.  
  245.  
  246. əəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəəə